home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Best of Shareware
/
Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso
/
mac
/
DOS
/
UTILITY
/
WRAP10
/
WRAPPER.DOC
< prev
next >
Wrap
Text File
|
1992-09-01
|
8KB
|
195 lines
================================================================================
WRAPPER.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
WRAPP86.SYS (8086): Ver. 1.0, Copyright (1992) by Philip B. Gardner
================================================================================
WRAPPER.SYS is a device driver which enables the loading of programs in
the CONFIG.SYS file as devices. The program may be a Terminate-and-
Stay Resident utility (TSR) or a program which simply executes but does
not stay resident. The driver DEBUGNXT.SYS is a companion to wrapper
which complements WRAPPER's special support for loading debuggers, like
MS-DOS's DEBUG. By loading a debugger in the config.sys, programmers
may trace and debug the initialization of device drivers. High memory
users may load WRAPPER and/or DEBUGNXT into high memory with a device
loader, or using MS-DOS 5.0's DEVICEHIGH command.
================================================================================
(Requirements)::
* 186 processor or better (WRAPP86.SYS and DEBUGN86.SYS are
included to support 8086/8088 processors)
* Requires MS-DOS Version 3.1 or better
================================================================================
(Installation)::
(CONFIG.SYS)::
Install WRAPPER.SYS in your CONFIG.SYS as a DEVICE
DEVICE=WRAPPER.SYS [options] program.exe (or .com) [program options]
All switch options and possible messages for WRAPPER are detailed
below:
================================================================================
(Syntax)::
The only thing to remember about syntax for the command line is
that just about anything works. What this means is that you
should be able to type in the options on the command line the
way they make sense to you.
To illustrate this point, the following command line example
is mutated several different ways.
DEVICE=WRAPPER.SYS /R- /P- /M4 MYPROG.EXE
DEVICE=WRAPPER.SYS -R- -P- -M4 MYPROG.EXE
DEVICE=WRAPPER.SYS -R--P-M4 MYPROG.EXE
... and so on.
(Switch Options)::
(REPORT):: R[+ or -] (toggle: default +)
Use /R- to disable messages from WRAPPER.SYS.
(PAUSE):: P[+ or -] (toggle: default +)
Use /P+ to enable the pause after the any report messages.
(NOPAUSE):: N[+ or -] (toggle: default -)
Use /N+ to never pause after the report, even if there
are errors. This switch can be used if your configuration
generates a warning or error message which you choose to ignore.
(DEBUGINT):: D[xx] (hex value: default ?)
Use /Dxx to tell WRAPPER to hook a user interrupt. This is
especially useful to ease the use of a debugger like MS-DOS's
DEBUG. A user vector is hooked by WRAPPER in the range of
int 60h - 67h. The target of the interrupt is the code necessary
to keep the debugger resident.
DEVICE=WRAPPER.SYS /C-/D/M32 C:\DEBUG.EXE
DEVICE=DEBUGNXT.SYS
DEVICE=MYDEVICE.SYS
(Display at boot-up):
WRAPPER.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
: User interrupt 60h hooked
(Debug's prompt):
-a 100 ; assemble at 0100
1234:0100 int 60 ; the instruction "int 60"
-g ; go
DEBUGNXT.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
(Stops at first instruction of MYDEVICE's strategy routine):
AX=0000 BX=03E6 CX=0000 DX=0000 SP=05A6 BP=0000 SI=0000 DI=0000
DS=0C96 ES=9087 SS=9087 CS=0C96 IP=0016 NV UP EI PL NZ NA PO NC
0C96:0016 2E CS:
0C96:0017 891E1200 MOV [0012],BX CS:0012=0000
-
When you use /D with no hexadecimal parameter, WRAPPER will search
for the 1st available interrupt. You may also specify the interrupt
to use (if not in use already), for example, /D63. A valid input is
a hexadecimal number between 60h and 67h.
(CLOSE HANDLE 0):: C[+ or -] (toggle: default +)
Use /C- to tell WRAPPER not to close file handle 0 (CON input/output)
after the specified program or TSR returns. This is useful for
programs which expect to write/read to STDOUT/STDIN after CONFIG.SYS.
MS-DOS normally rearranges the file handles after CONFIG.SYS, so that
AUX is handle 0. If the program uses to handle 0 after CONFIG.SYS,
the input/output will use AUX instead of CON. This will cause a
critical error (or interfere with communications), unless this switch
is used. MS-DOS's DEBUG is a good example of a program which
requires this switch, and then only if an INT 03h (Trap interrupt) is
encountered after CONFIG.SYS. See the DEBUGINT example above.
(MEMORY LIMIT):: M[nnn] (value: default ?)
Use /Mnnn to specify the amount of memory to limit a program to use.
This switch is useful when loading a TSR high, or when loading a
non-tsr like DEBUG, so that all available memory is not allocated by
the program. The value, nnn is in 1 Kbyte units, so /M32 would be
limit the memory used by the program to 32K. See the DEBUGINT example
above. The default (/M) is to use all memory available.
* everything in square brackets "[]" is optional
(CONFIG.SYS Line)::
DEVICE=WRAPPER.SYS [/Dxx][/C-][/R-][/P+][/N-][/Mnnn]
device default: /C+/R+/P-/N-/M?
* Don't hook a User Interrupt
* Close File Handle 0
* Report status messages
* Don't Pause after report
* Pause on errors or warnings
* Use all memory available
================================================================================
(Report Format)::
WRAPPER.SYS : Ver. 1.0, Copyright (1992) by Philip B. Gardner
ERROR : (Error Messages)
WARNING : (Warning Messages)
ADVICE : (Advisory Messages)
: (Report Messages)
: (Allocation Status)
PAUSE : Press any key to continue...
================================================================================
(Error Messages)::
MS-DOS version 3.10 or above is required
An 80186 processor or better is required
Bad or missing program specification
User Interrupts 60h - 67h are in use
================================================================================
(Warning Messages)::
Unknown option in command line
Extra characters on command line
================================================================================
(Advisory Messages)::
================================================================================
(Report Messages)::
User interrupt 00h hooked
Invalid Parameter for /D 00
================================================================================
(Allocation Status)::
================================================================================
(Changes)::
================================================================================